home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Utilitaires divers / Images / Rotater 2.6 / README 2.6 < prev    next >
Encoding:
Text File  |  1995-03-25  |  6.0 KB  |  211 lines  |  [TEXT/ttxt]
  1. Rotater 2.6
  2. ===========
  3. This is a program that reads a set of 3-dimensional points
  4. and lines and plots them in a window. The image can then
  5. be rotated with the mouse in real time.
  6.  
  7. Requires System 7 or greater.
  8. 8 bit colour screen and Power Macintosh preferable.
  9.  
  10.  
  11. Versions
  12. --------
  13. Rotater-FAT-2.6
  14. A fat binary for PowerMacs and 68K Macs
  15.  
  16. Rotater-881-2.6
  17. A binary for 68K Macs with an FPU
  18. Will not run on a PowerMac or a 68K Mac with no FPU
  19.  
  20.  
  21. Changes from 2.0
  22. ----------------
  23. A new icon :-)
  24. faster!
  25. Can now have a white background in 3D-Glasses Mode.
  26. Recompiled with CW5 - slightly faster again.
  27. New folder icon :-)
  28. Floating Info Windows.
  29. New folder icon for rotater files :-)
  30. Can now center object on the screen
  31. Reads in large files more than 20 times faster
  32.  
  33.  
  34. Help
  35. ----
  36. The program has balloon help for all of the menu items.
  37.  
  38.  
  39. Rotation Method
  40. ---------------
  41. Click on the image and hold the mouse button down. Moving the
  42. mouse now rotates the image.
  43.  
  44. The track-ball rotation method is used to rotate the image.
  45. Imagine the image is inside a clear ball. Dragging the mouse
  46. across it is like rolling the ball. Try it and see :-)
  47.  
  48. If you have the Grab & Spin option set under the action menu,
  49. when you let go of the mouse button while still moving the mouse
  50. the image will continue to rotate in the same direction.
  51. Stop all rotation by clicking the mouse once. You may need to
  52. hold the mouse button down for a while on slow machines.
  53.  
  54. Drag & Spin will not work if the image takes longer than 1/4 of a
  55. second to calculate and draw. Copying to very large windows slows
  56. the program down considerably.
  57.  
  58.  
  59. Keyboard Rotations
  60. ------------------
  61. The "x", "y" and "z" keys rotate about their respective axes. By
  62. holding the shift key down when using them, the image will rotate
  63. in the opposite direction. The arrow keys can also be used for
  64. rotating the image.
  65.  
  66. The 'x' axis runs left and right across the window, 'z' runs up
  67. and down the screen and 'y' runs into and out of the screen.
  68.  
  69.  
  70. Resizing the Viewing Window
  71. ---------------------------
  72. The viewing window can be resized using an invisible handle on
  73. the bottom right corner of the window.
  74.  
  75. Maximum window size is full screen on a 16" monitor.
  76.  
  77. Square windows are optimal in normal mode. Windows twice as
  78. wide as they are high are optimal for stereo mode.
  79.  
  80. Smaller windows run faster.
  81.  
  82.  
  83. Saving Images
  84. -------------
  85. Images can be saved to disk either as a 72 dot per inch
  86. bitmap or as 300 dpi Vector picture that can be edited and
  87. printed from draw type programs. Note that there is an upper
  88. limit for the number of elements that can be saved in vector
  89. format somewhere around 20,000.
  90.  
  91. Note that files saved at 300dpi have joins at 72dpi intervals
  92. when imported to some programs. I dont know how to fix this.
  93.  
  94.  
  95. Maximum Number of Points/Lines
  96. ------------------------------
  97. The default memory allocation for the program should be enough to
  98. read about 20000 points or lines in. To increase this number,
  99. increase the memory allocation in the programs "Get Info" box.
  100.  
  101. You will receive a warning if you try to read in a file that is
  102. too large for available memory.
  103.  
  104.  
  105. Speed of Rotating
  106. -----------------
  107. Smaller windows run faster.
  108.  
  109. Hiding lines slows the program down especially on non-PPC machines.
  110.  
  111. Thinner lines and smaller dots run faster.
  112.  
  113. Make sure your monitor is in 8-bit mode with the System colour
  114. palette for maximum speed.
  115.  
  116. This program runs VERY VERY much faster on a Power Macintosh than
  117. on a 68K Macintosh (about 10 times faster!).
  118.  
  119. Points plot VERY much faster than lines. 10000 points can be
  120. comfortably manipulated on a Power Macintosh 6100/60.
  121.  
  122.  
  123. Format of the Input File
  124. ------------------------
  125. The input file consists of sets of four points on each line
  126.  
  127. x y z c
  128.  
  129. x = x coordinate of a point (real)
  130. y = y coordinate of a point (real)
  131. z = z coordinate of a point (real)
  132. c = colour and/or drawing method (integer)
  133.  
  134. if (c = 0) move to the x,y,z point without drawing
  135. if (c > 0) draw a line to the x,y,z point from the current
  136.            position using colour c
  137. if (c < 0) draw a dot at x,y,z using colour -c
  138.  
  139. where
  140. if (c = 1) colour is red
  141. if (c = 2) colour is green
  142. if (c = 3) colour is blue
  143. if (c = 4) colour is yellow
  144. if (c = 5) colour is purple
  145. if (c = 6) colour is cyan
  146. if (c > 6) colour is white
  147.  
  148. eg
  149. 0.5 2.3 -1 0  # moves to point 0.5 2.3 -1 without drawing
  150. 3 5 6 2       # draws red line from 0.05 2.3 -1 to 3 5 6
  151. 5 -5 2 -3     # plots blue dot at 5 -5 2
  152.  
  153. The points are automatically scaled to fit in the window and
  154. rotation is about 0,0,0.
  155.  
  156. The input file can be any text file.
  157. # Comment lines begin with the '#' character.
  158. Text after the four points on a line is ignored.
  159. Completely blank lines are ok (they are ignored).
  160.  
  161. Contiguous comments at the very start of the file are read in
  162. and displayed in the program in the File Comments window.
  163. Use this to explain to the user what the image is and where
  164. it comes from. Try to keep it short otherwise the window gets
  165. too big. Internal documentation can be placed in other
  166. comments after a blank line.
  167.  
  168.  
  169. Notes
  170. -----
  171. This program is free and I take no responsibility if it kills
  172. your machine or drives you mad. Use at your own risk.
  173.  
  174. It may not be sold.
  175.  
  176. Source code and project files for the Metrowerks CW5 compilers
  177. are available at the archive site or on request.
  178.  
  179. E-mail me if you find a use for this program or come up with a
  180. cool set of points/lines worth adding to the collection.
  181.  
  182. The official Archive site for source code, new updates,
  183. rotation files etc is:
  184.   ftp://raru.adelaide.edu.au/rotater
  185. or
  186.   http://raru.adelaide.edu.au/rotater
  187.  
  188.  
  189. Thanks To
  190. ---------
  191. Thanks go to the following:
  192.  
  193. Metrowerks for a great compiler.
  194. Toby Thain and Dale Greer for help speeding up the program.
  195. Andrew Maloney for speed and floating window help.
  196. Tim Olson for bzero.
  197. David Doak, Charles Williams and E.J. Chichilnisky
  198.  for many helpful suggestions.
  199. Richard Chipper for the new icons.
  200. Troy Gaul for the Infinity Windoid WDEF.
  201. Patrick Rabou for help speeding up file reading.
  202.  
  203. Numerous people for rotation files (see comments in the files)
  204.  
  205.  
  206. Enjoy
  207.  
  208. Craig Kloeden
  209. craig@raru.adelaide.edu.au
  210. 25 March 1995
  211.